home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Almathera Ten Pack 3: CDPD 3
/
Almathera Ten on Ten - Disc 3: CDPD3.iso
/
scope
/
151-175
/
scopedisk165
/
amigantt4.0
/
amigantt.doc
< prev
next >
Wrap
Text File
|
1995-03-19
|
78KB
|
1,695 lines
AMIGANTT
Project Management Tool
Version 4.00.00
Program Description
November 1, 1990
AMIGANTT
Table of Contents
1.0 Introduction
1.1 Purpose of the software
1.2 Features of AMIGANTT
1.3 Restrictions
1.4 Installing the software
2.0 Creating a Project
2.1 Main Screen
2.2 Menu Options
2.2.1 Project Menu
2.2.2 Window Menu
2.2.3 Task Menu
2.2.4 Print Menu
2.2.5 Sort Menu
2.2.6 Misc Menu
2.3 Adding the Project Header
2.4 Adding Tasks
2.4.1 Adding another project as a task
2.5 Modifying Tasks
2.6 Deleting Tasks
2.7 Saving the Project
3.0 Printing a Project
3.1 Printing the Screen
3.2 Printing the Project
3.2.1 Gantt Chart
3.2.2 Task List & Summary
3.2.3 Resource Summary
3.2.4 Resource Histogram
3.2.5 Pert Chart
4.0 Modifying Existing Projects
4.1 Loading the Project
4.2 Changing the Header Information
4.2.1 Conversion of Costs/Durations
5.0 ARexx Interface
6.0 Enhancements for version 4.00.00 of AmiGantt
and known anomolies
AMIGANTT -- Project Management Software
1.0 Introduction
1.1 Purpose of the software
AmiGantt was designed to create a simple, interactive method of
outlining the tasks required to complete a particular project, using
the GANTT chart as the input format.
There are other programs in the microcomputer world using a similar
interface, but none that I could find for the Amiga, and none that
had the range of project flexibility I thought a manager would need.
Many project management systems systems tend to be rather 'batch'
oriented and require a fair amount of task and resource planning before
you ever get to the computer screen. The intent with AMIGANTT was to
provide a simple, easy-to-use tool for tracking of tasks, their
duration, and their resources.
Because I'm most familiar with the top-down approach to project
definition -- where the major tasks are broken down to finer
and finer levels of description to very simple activities -- it was
decided to build the primary interface around a GANTT chart. In this
way, the tasks already entered can be viewed at all times as subsequent
levels of detail are added.
AMIGANTT can run on any Amiga computer (500, 1000, or 2000) under
Workbench 1.2 and above(!!). Version 4.00.00 of AmiGantt requires the
ARP library installed in the LIBS: directory before use.
1.2 Features of AmiGantt
- utilizes a top-down approach to project definition, based on a GANTT
chart interface
- written to make maximum use of the Amiga, it utilizes an
Intuition-based interface with drop-down menus and Amiga-key
replacements to select functions.
- displays the project in a multi-window mode with separate windows
for the Gantt Chart, task information input, resource histogram
display and Pert Chart display
- AmiGantt is well behaved in the multi-processing mode and should have
no problem working with other programs.
- can be run from either Workbench, via the supplied icon, or directly
from CLI. Users running the program from CLI can optionally
provide the name of the input project file they wish to work on.
AMIGANTT also optionaly creates icons for each project saved,
which allows Workbench users to directly enter the project simply
by double-clicking its icon. With version 3.00.00 and above,
a menu selection is provided so the user may have AmiGantt
generate or not generate icons for saved projects.
- AmiGantt will notify the user of low-memory situations and provide a
graceful exit. It uses a dynamic-memory allocation scheme so that
only enough space is taken to hold the tasks defined for the
project. As tasks are deleted from the project, AMIGANTT will
free the memory allocated to them.
- up to 500 tasks may be defined for any project and a project may
contain other projects as tasks (e.g. sub-projects)
- text-only entries may be defined to provide headings to help separate
major tasks, or to provide additional description on the Gantt
chart
- Milestone tasks may be defined to identify reaching certain points
in the project. Milestones can be tied to a particular date or
dependant on other tasks.
- the calendar and task fields may be scrolled separately to allow
viewing of any part of the Gantt Chart
- the project format may be displayed as daily, weekly or monthly with
conversion routines between each format
- sub-projects are also automatically converted
- any task in the project (except headers) may be dependent
(cannot start until the first is finished) on up to
10 other tasks
- calculated dependencies are supported, so the user may define that
a task begins 5 days after the end of another task or 2 months
before the beginning of another task.
- can store planned and actual parameters of tasks (start date, end date
duration)
- up to 10 resources may be defined for each task
- costs for each resource may be uniquely defined in each task
- costs for each resource may defined as 'fixed' (do not change
with the duration of the task) or 'variable' (change with
with the duration of the task)
- each resource may be assigned a 'usage percentage' which
determines the amount of their total time is dedicated to that
task
- costs and resources are retained to aid in the adding of new
tasks
- task start dates may float based on other task dependencies or the
project start date, or a start date may be specified
- tasks may optionally have an 'ending date' attached which will
become the latest end date for the task. This allows tasks to
include a 'float' period if this end date is beyond the time
needed for the task.
- printouts available include
- Screen image
- Gantt Chart
- Resource Histogram
- Pert Chart
- Resource Summary
- Task Listing (Detail)
- Task Summary
- printouts may be aborted by pressing the ESC key at any time.
- printouts for the Gantt Chart, Resource Histogram, and Pert Chart
may be printed in Graphic bitmap mode or in text mode, depending
on the characteristics of the printer.
- using the Amiga Preferences program, graphics printouts may be
printed horizontally or vertically.
- AmiGantt 4.00.00 supports two ARexx ports -- an input port to allow
an ARexx macro to run AmiGantt and initiate many of the menu options;
and an output port which allows ARexx macros to be attached to tasks
to run other ARexx-supporting programs such as Editors, sound players,
IFF file displays, spreadsheets, etc.
1.3 Restrictions of AmiGantt
NOTE -- These are restrictions placed on version 4.00.00 of AMIGANTT. They
may be removed in subsequent releases of the software.
- 500 tasks per project
- 10 dependent tasks per task
- 10 resources per task
- task descriptions are limited to 30 characters each
- resource descriptions are limited to 15 characters each
- resource cost per unit (day/week/ or month) cannot exceed $9999.99
1.4 Installing the software
AmiGantt consists of a single program file, called AMIGANTT, which can
be placed anywhere the user desires. In most cases, installation will
simply consist of copying this file into the desired directory.
WorkBench users may simply drag the AmiGantt icon included on the
diskette to the desired drawer.
Project files created by AmiGantt are placed according to the user's
wishes and hence, may also be located on any convenient disk volume.
It can be run from either CLI or Workbench and an icon file has been
provided for the latter (appropriately enough, called AmiGantt.info).
The icon file should be copied to the same directory as the AmiGantt
program.
Version 3.00.00 of AmiGantt and above make use of some of the
features provided by the ARP library (AmigaDos Replacement Program)
such as the file requestor and the CLI startup processing. In
order to support these features, version 34 (or above) of the ARP library
must be installed in the LIBS directory of your system disk. A
copy of this library, called arp.library is provided on the disk.
This file should be copied to LIBS: and your Amiga re-booted before
using AmiGantt 4.00.00.
AmiGantt -- Project Management Software
2.0 Creating a Project
2.1 Main Screen
When the program is first started, the first thing the user will see
is the Main Screen of AmiGantt. The screen shows a blank task list
and calendar area.
______________________________________________________________________________
|_| AmiGantt 4.00.00 | | |
Apr'88 11111 11222 22222 May'88 1111 11112 22222 33
___ 12345 89012 56789 23456 90123 67890 34567
|*|1 Task descriptions ^
|*|2 |
|*|3 Date Calendar
|*|4
|*|5
| |6
| |7
| |8
| |9
| |10
| |11
| |12
| |13 <--- Task numbers
| |14
| |15
| |16
| |17
| |18 Date scroll gadget
| |19 |
| |20 |
| | |
| |<-- Task scroll gadget _______________________|__________________________
|_|________________________|_________________________________________________|
2.1 Main Screen (Cont'd)
The Calendar on the main screen is defaulted to the daily format and
will begin on the Monday previous to or on the current system date --
which is usually today. The top left corner of this screen will
display the version number of AmiGantt.
Below the title line is the main body of the AmiGantt Gantt Chart.
The numbers on the left side of the screen are the task numbers for
each of the lines in the Gantt Chart. These numbers are used as
reference in AmiGantt and should be used when describing dependencies
between tasks. Immediately to the right of the numbers is where a
portion of the text description of each task will be displayed. Have
no fear, the full task description is provided on all printed output.
To the right of the descriptions will appear the task duration bars,
showing when the task occurs on the calendar. In some cases, tasks may
extend beyond the right side of the screen or may even start on a date
beyond the right edge. To view the task pointers for these, the date-
slider gadget at the bottom of the screen may be used to shift the
calendar 'window' to the right or left. You can also shift the
calendar display left and right 1 week at a time using the right and
left cursor keys. Note though, that the calendar will not shift beyond
the project starting or ending dates.
CURRENT TASK --
The blue block shown in the task area highlights the 'current task'.
Any task operation, such as add, modify, or delete will operate on this
highlighted 'current task'. The current task may be changed by either
moving the highlight block up or down using the cursor positioning keys;
or by placing the mouse pointer anywhere in the description field of
the desired task and pressing the left mouse button.
You can scroll the task numbers in the display using the task scroll
gadget at the left of the screen. It is possible to scroll the current
task off the displayed portion of the screen. AmiGantt keeps track of
the current task though, and will highlight it when it appears on
the screen again.
If you use the cursor positioning keys to select the current task, the
task display will automatically scroll up or down (if possible) when
you hit the top or bottom of the display -- in order to keep the
current task visible.
2.2 Menu Options
As with any good Amiga program, AmiGantt functions are selected using
the drop-down menus displayed when the right mouse button is pressed.
There are six sets of menus available in AmiGantt: The PROJECT menu,
WINDOW menu, TASK menu, PRINT menu, SORT menu, and the MISC menu. The
various functions available in AmiGantt are logically collected under
these menus and are described below. For those users more comfortable
on the keyboard, there are Amiga-key replacements for the major
options.
2.2.1 Project Menu
This menu deals with functions that affect the entire project that is
being worked on. It also includes some information about AmiGantt and
the ability to quit the program. Each of the options found in this
menu are described below.
Load Project (Amiga L)
To continue work on an already defined and saved project file,
select Load Project and then fill in the name of the project file
to be loaded into AmiGantt. More information on saving and loading
of project files is provided in section 2.6 of this manual.
Save Project (Amiga S)
Save Project allows the user to save the latest contents of the
project to a file on disk. If a previous project was Loaded into
AmiGantt for modification, Save will assume you want to use the same
file name again and will prompt to ask if it's OK to wipe out the
existing project file. If no file was previously loaded, Save will
prompt the user to provide a suitable name for the project to be
stored on disk and to write out the project tasks to that file.
This file may then be loaded back into AmiGantt at any time (see
Load Project above) for revision or update.
Save As
This option allows the user to save the project to disk by directly
asking for the file name he/she wishes to use. Again, if need be,
AmiGantt will prompt to ask if it's all right to overwrite an existing
file.
New Project (Amiga N)
By selecting New Project, the user can remove all tasks from
the project and start with a clean slate.
Info
Selecting this option from the Project menu will display a window
with the current version number of AmiGantt and some information on
how to get in touch with the author.
Quit (Amiga Q)
Selecting the Quit option from the Project Menu allows the user
to leave AmiGantt. The same action may be accomplished by hitting the
close window gadget at the top left of the Task (or Gantt) Window.
If there were changes to the project and it has not been saved lately,
AmiGantt will notify the user that changes to the project may be lost
and will give the option to go back into AmiGantt and Save the
project before exiting. Selecting the Cancel gadget in the 'Want to
Leave?' requestor will return the user to normal AmiGantt main screen
with the option to select the Save or Save As menu options.
If the user wishes to ignore the changes made to the project, he
should select the OK gadget from the requestor.
If AmiGantt detects that no changes have been made to the project,
selecting Quit will immediately leave the project without asking if you
want to save.
2.2.2 Window Menu
AmiGantt contains three main windows for display of the task
information provided for a project. They are: a) the Gantt (or Main)
Window, b) the Resource Window, and c) the Pert Window.
Pert Chart
When this function is selected, AmiGantt will open an additional
window which will display the real-time updated Pert or Network chart
for the project. Along the bottom of the window is a date scroll
gadget which can be used to change the range of dates shown. The dates
shown in the window can also be changed a week at a time using the
right and left cursor positioning keys.
Resource Histogram
As with the Pert Chart function above, selection of this option will
cause AmiGantt to open an additional window which will display the
current resource allocation for the project in histogram format. The
Resource Window function will also open a Legend Window which displays
the pattern used in the histograms for each of the project resources
used within the time period shown in the window.
Along the bottom of the window is a date scroll gadget which can be
used to change the range of dates shown. The dates shown in the window
can also be changed a week at a time using the right and left cursor
positioning keys.
The windows have all the usual gadgets assigned so that they may be
moved or resized. There are no menus assigned to either of the
windows, but they may be closed by clicking on the close-window gadget
in the top left corner.
2.2.3 Task Menu
Functions in this menu allow the user to define, delete, and modify
the tasks contained within a project. It also allows him/her to
modify the default header information created for each project.
NOTE (again) It is STRONGLY URGED THAT THE USER FIRST SET UP THE
PROJECT HEADER by selecting the Modify Header option from this menu
before proceeding with the addition of new tasks. See section 2.3
of this manual regarding the addition (modification) of the project
header.
Add Task (Amiga A)
This option is selected to add new tasks to a given project.
More information on adding a task is provided in section 2.4 of
this document. It should be noted, though, that AmiGantt works
on an 'insert before' mode of task addition. In other words, if
the current task block is on a task number that has no description
for it and Add Task is selected, AmiGantt will add that task
number. If the current task block is positioned over a task number
that does have a description and Add Task is selected, then
AmiGantt will push all the tasks at the cursor position and below,
down one line on the screen and insert the new task at that
position. Again, more information on this will be provided in
section 2.4.
Delete Task (Amiga D)
The user can remove a task by setting the current task block over a
task description and selecting Delete Task. Before actually
removing the task, AmiGantt will present the entire task
description and give the user the option to gracefully back out.
If you really want to remove the task, select the OK gadget at the
bottom left of the task window. If you thing better of it and want to
keep the task, select the CANCEL gadget at the bottom right of the
window.
Modify Task (Amiga M)
By setting the current task block over a previously defined task, and
selecting Modify Task, the task fields are presented for changes. When
the desired changes have been made, click on the OK gadget at the
bottom left of the task window. If you change your mind and don't
want to make any changes to the task, click on the CANCEL gadget at
the bottom right.
Move Task
NOTE -- This option is not available in version 4.00.00 of AmiGantt.
When functioning, it will allow the user to pick up a task and move
it to another place in the Gantt Chart listing.
Modify Header (Amiga H)
Each project contains a 'header' that contains global information
about the project. More information about the header information
is contained in section 2.3 of this manual. Selecting Modify Header
allows the user to view and modify this global information.
IT IS STRONGLY RECOMMENDED THAT THIS OPTION BE SELECTED FIRST
WHEN STARTING A NEW PROJECT -- BEFORE PUTTING IN ANY TASKS.
2.2.4 Print Menu
This menu allows the user to select various options for output of
reports from AmiGantt. During the operation of these options, the
mouse pointer image will change to that of a printer with PIP (Print In
Progress) at the bottom. This is to remind the user that AmiGantt
will not process any other functions until the printing is complete.
At any time during the printing process, the user can cancel the
printout by pressing the ESC key on the keyboard.
Output to...
When selected, this option presents a sub-menu with two further
options. It allows the user to select whether print output should be
routed to the PRT: (Preferences Printer) device or to a file on disk.
The options are mutually exclusive and operational for all output from
AmiGantt.
If output to a file is selected, a file requestor window will be
presented, asking the user for the name of a file in which to store
the output reports.
Just a note here -- Output to a file will not prompt if the
file already exists so selection of a second report will wipe out the
first.
Print Type
When selected, this option presents a sub-menu with two further
options. It allows the user to select whether print output should be
of a 'textual' type (using normal ASCII characters to generate the
Gantt, Pert, and Resource reports) or a Graphic Bit-Map type (where
an graphical image of the Gantt, Pert, and Resource charts, similar
to the display on each of the windows but without the gadgets).
The options are mutually exclusive and operational for all output from
AmiGantt.
Print Screen
As would be expected by the description, selecting this option with
the Output to... option set to PRT: will cause a screen 'dump' of what
is currently being displayed to be routed to the user's default
printer. If the Output to... option is set to file, AmiGantt will
create an IFF file for each of the windows (Gantt, Resources, and Pert)
that are being displayed at the time. As the files are being created,
each window will be brought to the front of the display as it is being
saved.
Print Project
Selection of this option causes AmiGantt to generate a complete
printout of the entire project, including Gantt charts, task listings,
resource histograms and the Pert Chart. More information regarding the
project printouts is provided in section 3.2 of this manual.
Print Tasks
Selecting this option provides printouts of the Task Summary and
complete Task List of the Project.
Print Resources
This option prints out the Resource Histogram and Project Summary.
More information on these project reports are found in section 3.2 of
this manual.
Print Gantt Chart
Selecting this option provides the user with just a printout of the
project Gantt Chart, similar to the display on the main screen.
Print Pert Chart
This option will print out the network chart of the project.
2.2.5 Sort Menu
By selecting any of these options, the tasks in the project will be
sorted and re-ordered in the display according to the criteria
selected.
Sort by Starting Date
In this option, the tasks will be sorted and displayed in
ascending order of each task's earliest starting date. Headers
and Milestones are placed at the end of the task list.
Sort by Competion Date
Here, the tasks are sorted and displayed in ascending order of the
latest ending date of each task. As with the sort by Starting
Date, Headers and Milestones are placed at the end of the task
list.
Sort by Critical Path
In this option, AmiGantt will examine the list of tasks and determine
those that form the Critical Path through the project. For AmiGantt,
the Critical Path is defined as the set of tasks that form a continuous
path from the begining to the end of the project. If there are
multiple paths, the one with the longest duration is taken as the
Critical Path. The tasks in the Critical Path are then floated to the
top of the task display. The order of other tasks is maintained and
they are displayed below the last task in the Critical Path.
NOTE: At this time, there is no way to 'undo' a sort. If you have any
doubts, save the 'sorted' version as a separate file.
2.2.6 Misc Menu
Write Icons
This option is basically an on-off switch which selects whether
AmiGantt will generate an icon when the Save As option is selected.
The icon will contain all the necessary information to run the
project directly from the WorkBench.
Identify Critical Path
This option is also an on-off switch which tells AmiGantt to find
tasks which are on the Critical Path for the project, and change
their display colour in the Gantt Chart. AmiGantt determines the
Critical Path by examining all possible paths from the end of the
project back to the beginning, then selecting the one with the
longest duration. While this switch is on, AmiGantt will
dynamically re-evaluate the path with each change to the task list.
This can significantly slow down the processing on input of tasks.
Modify Colours
When this option is selected from the Misc Menu, a separate window
will open up with slider gadgets to adjust the Red, Green, and Blue
composition of the colours used in the screen. The colour register
being adjusted is shown in the lower right corner of the window,
and the up and down triangles are gadgets to select which colour is
being adjusted. Once the colours have been adjusted to your liking
simply close the window. The colours will be automatically saved
with the project when the Save or Save As options are selected.
The Defaults gadget in the lower left of the box will return the
colours to the original default set programmed within AmiGantt.
2.3 Adding the Project Header (Modify Header from Task Menu)
As mentioned in section 2.1, each project contains a 'header' which
holds certain global information about the project. The types of
information stored in the header are:
a) a description of the project
b) the start date of the project and
c) the type of calendar used in the project (it can be daily,
weekly or monthly)
d) the default colours used in the project
When Modify Header is selected from the Task Menu, AmiGantt will
present the Header Modification window and allow the user to modify
these global values. (Note: Colours are modified from the MISC menu item)
If you are just starting out in a new project, the fields displayed
here will be set up with some initial default values. The Description
fields will be blank, the Project Start Date will be set to the
current system date, and the Calendar will be set to 'D' for Daily
format.
If a previously defined project was loaded using the Load Project
selection from the Project Menu (see section 4.1), then these fields
will display the values retrieved from the project file.
DESCRIPTION -
The Project Description field consists of 3 lines of 40 characters
each in which you may place any descriptive information you wish about
the project. Since the first line of the description will be used as
title for the project and will be displayed in the top line of the
Main Screen, it is suggested that this first line contain some sort of
appropriate title for the project as a whole.
The Description field will accept any characters, alpha or
numeric, in upper or lower case. If you wish, any or all of the
description lines may be left blank.
START DATE -
This field describes the overall start date for the project. As
mentioned above, it is defaulted to the current system date, but
you may change this to any value you wish. The date provided
here will be used by AmiGantt to modify the calendar display on
the Main Screen -- re-setting the first calendar entries on the
left side of the screen starting with the project start date.
This field also interacts with the Calendar field below it, in
that a Daily Calendar will use the exact date provided as the
project start date; a Weekly Calendar will take the Start Date if
it's a Monday, or move it to the previous Monday; and a Monthly
Calendar will move the Project Start Date to the first of the
month for display purposes.
The entry in this field is input in standard YYYYMMDD format where
YYYY is the four digit year, such as 1988; MM is the two digit
number of the month, such as 07 for July; and DD is the two digit
number for the day of the month, such as 29. (It was done this way
to make it easier for AmiGantt to do sorting and comparisons).
Only numeric values are accepted in each of the fields and the
date is validated to make sure it is a real date (i.e. not the
31st of February).
CALENDAR -
This field specifies the type of calendar entries the project
will use. If 'D' for Daily is selected, the project accounting
and record keeping will provide for input on particular days and
all displays and reports will provide daily information. If 'W'
for Weekly is selected, AmiGantt will deal with project tasks and
entries on a weekly basis, with the smallest valid time unit being 1
week. As you might expect, the 'M' Monthly calendar provides for
AmiGantt looking at the project from a monthly perspective.
AmiGantt 4.00.00 will accept either uppercase or lowercase letters
for the calendar (i.e. D or d, W or w, M or m) The lowercase
versions will be automatically converted to the uppercase
equivalent.
After the user has made the appropriate changes, he should select the
OK gadget in the lower left of the window to make the modifications to
the project header. If he decides not to make changes at this time,
he should select the CANCEL gadget in the lower right of the window to
return to the Main Screen.
NOTE -- The user can also move from field to field in the Header
Modification window by pressing the RETURN key. However, pressing
RETURN after the Calendar field will have the same effect as selecting
the OK gadget.
2.4 Adding Tasks
After the project header information has been updated to set up the
global environment for the project, the next step is to start adding
the individual tasks that make up the project. AmiGantt has been
designed to let the user work in a top-down manner in defining the
project -- setting out the major tasks to be accomplished, then
providing finer and finer detail of sub-tasks to be completed.
AmiGantt works on an 'insert-previous' mode for determining the
placement of tasks. While the user does not have to specify the number
of the task (AmiGantt handles this automatically), the current task
block (see section 2.1) is important in determining where the task will
be added.
When adding a task to a project, the user should position the current
task block over one of the tasks shown at the left of the screen.
If the block is positioned on a line with no existing entry (i.e. the
description shown to the right of the number is blank) and Add Task is
selected, then AmiGantt will insert the task at the number shown on
that line. If, on the other hand, the block is positioned on a line
with an existing entry and Add Task is selected, the the task will be
inserted before the existing task entry. (Actually, the new task will
be added at the task number on that line and all others after it will
be pushed down one line, giving them task numbers one larger, but the
apparent effect is that of inserting before the current task).
Once a task number has been highlighted and Add Task has been selected,
AmiGantt will present the Add Task window, where the user may fill in
the pertinent information about the task.
The Task Window has undergone significant change for version
4.00.00 It now consists of 4 separate windows:
a) The Main Window where the general and planning
information regarding the task are
provided;
b) The Resource Window where the user provides
descriptions of people and things
used in the task;
c) The Actuals Window where tracking information about
what really happened is recorded;
d) The ARexx Window where the user can attach an ARexx
script to the task to run ARexx-
compatible editors, word processors
IFF-file viewers, or spreadsheets.
This will allow the attachment of
additional information or
background to the task.
When task options (such as Add, Modify, or Delete) are selected
from the menu, the Task Main Window is displayed. At the bottom
of the window are the usual OK and CANCEL gadgets to select or
cancel the operation, as well as three additional gadgets to open
up the Resource, Actuals, or ARexx windows. The EXECUTE gadget,
also at the bottom of the Task Main Window, will cause immediate
execution of the ARexx macro script attached to the task.
When the Task Main Window is opened, it provides its own menu with
Amiga-key equivalents for each of the gadgets at the bottom of the
window.
If the user decides that he did not really want to add a task at this
time, selecting the CANCEL gadget at the bottom right of the window
will return him to the Main Screen.
TASK MAIN WINDOW
Description -
The Task Description field is an alpha-numeric field of 30
characters in which a short description of the nature of the task
can be provided. Although only the first 20 or so characters of
this description will be shown on the Main Screen, all reports
will show the entire description. The user may input any
information in this field. IT IS STRONGLY URGED THAT SOME SORT OF
NON-BLANK DESCRIPTION BE PROVIDED FOR EACH VALID TASK.
Start Date -
As with the Project Start Date described in the 'Adding the Project
Header' section of this manual, the task start date defines an
absolute starting date for the task. It is in the same YYYYMMDD
format and is validated for things like a month number of 13, days
beyond 31, etc.
In the case of the Task Start Date though, leaving the date field
blank has a special meaning. It allows the task to 'float', with its
actual start date changing, depending upon other tasks or the Project
Start Date. If a task is specified with a blank start date and it is
not dependent on any other tasks, then the actual start date of the
task will float with the Project Start Date. That is, the task start
date will be assumed to be the same as the Project Start Date and will
change automatically with any changes made to the Project Start Date
via the Modify Project Header selection.
If a blank Task Start Date is specified and this task is dependent on
other tasks (i.e. it cannot start until other tasks have been
completed) then the actual start date of the task will float with the
completion of the other dependent tasks. So, if Task 2 (which we are
working on) is dependent on Task 1 (meaning Task 2 can't start until
Task 1 is completed), then Task 2's starting date will become the day,
or week, or month -- depending on the project calendar -- after
Task 1 is scheduled to complete. If we change Task 1's start date or
duration, then Task 2's start date will be automatically updated.
End Date -
As with the Start Date field, entries here should be in the same
YYYMMDD format. Values for this field need not be supplied unless
you want to set an absolute 'must finish by' date for this task.
AmiGantt will interpret this field to be the latest possible end
date for the task. When displaying this task in the Gantt chart
this entry will also be used to determine if there is any 'float
time' between the starting date of the task, plus its duration,
and the end date supplied. If there is excess, AmiGantt will
display this 'float' period as a set of dots on the Gantt Chart.
Leaving this field blank simply means that the end date for the
task will be determined by the start date plus the duration. Any
changes in the start date (due to task dependencies, etc.) will be
automatically reflected in a new end-date for the task.
Duration -
This field specifies the length of time it is planned to complete the
task. The units of time for this field will depend upon the selection
made for the Project Calendar type in the Header Fields. (See
Section 2.3).
The Duration field is numeric only and will not accept negative
numbers.
A project task with a Planned duration of 0, no start or end
date and no dependencies has a special meaning in AmiGantt. It
denotes a 'header line' placed in the Gantt chart just to make things
more readable, separate groups of tasks, or provide additional
explanation.
If a Dependency is supplied for a task with duration = 0, this
tells AmiGantt that this is a Milestone. It is recorded in the
Gantt Chart by an asterisk (*).
Depends On -
In this field, the user describes any other tasks that must
be completed before this task may start. In other words, that
this task's start date is dependent on. Up to ten other tasks may
be defined in this way and their task numbers should be placed in
the Depends On field, separated by spaces or commas. (e.g. 8 9 10
or 8,9,10)
Version 3.0.0 of AmiGantt and above support 'calculated dependencies'.
In this case, you can specify that at task will begin 3 days after
the end of another task. Or 2 months before the start of another
task. To implement this feature, you simply append a '+' or a '-'
sign directly after the dependent task number, followed immediately by
the number of units (days, weeks, or months.) The '+' sign means that
the units following are added to the end of the dependent task and
the '-' sign signifies time before the task start date.
(5+14 = 14 days after the end of task 5
17-2 = 2 months before the start of 17.)
As mentioned in the Start Date field above, if the Task Start
Date is left blank and dependent tasks are defined in the
Depends On field then AmiGantt will look at each of the
dependent tasks -- find out which has the latest end date -- then set
the actual start date of this task to the next day, week, or
month after that ending date. As far as the user will see, the
task will still show a start date of blank but it will 'float'
depending upon the start dates and durations of the dependent
tasks. The beauty of connecting tasks together this way is that
if one task is changed, or the project start date is updated,
AmiGantt will manage and modify all the connections of tasks and
adjust project schedule accordingly.
RESOURCES WINDOW
The fields on the Task Resource Window allow the user to specify
up to 10 resources (typically people doing the project) that are
assigned to this task and the cost, on a per-unit-of-time basis,
for each.
Title
The Title fields (right below the RESOURCES: description) are 15
characters long, will accept any alphanumeric characters, and can
be used to provide peoples names, initials, or job descriptions.
Cost
The Cost fields to the right of the Title fields, are numeric
only. They will accept up to two decimal places and even
negative numbers (if using someone or something can actually
reduce the project cost). The '$' sign is unnecessary and
invalid for this field.
Any or all of these fields may be left blank. Cost fields which
are left blank are assumed to be 0.00
F/V
To the right of the Cost fields is a single character field marked
'F/V'. This field is used to indicate if the cost for a particular
resource is Fixed or Variable. If the default value of 'V' is left
in this field, then the cost of the resource is Variable and will be
multiplied by the task duration to determine the real cost. If an 'F'
is placed in this field to specify that the cost is fixed, then there
will be no calculation and the cost is assumed to be that set value, no
matter how long the project_duration.
Pct Used
At the right side of the window is a column of PCT USED fields.
These specify how much of a person's or resource's time is dedicated
to this task. The values in these fields are expressed as
percentages - from 0 to 100. The fields default to 100%, but if,
for example, a person was only to spend half their time on this task
and half on administrative duties, you would fill in 50 in the PCT
USED field. The Resource Histogram display and the Resource
printouts will use this value to correctly apportion allocation and
costing.
ACTUALS WINDOW
The Actuals Window provides a place to store information on the
'reality' of the task -- as opposed to what was planned. Where
provided, AmiGantt will display the results of the Actuals along
with the Planned values, to allow comparison.
Actual Start Date
This, as expected, should reflect the date on which the task
actually started. The format for this date is the standard
YYYYMMDD. Leaving this field blank has no particular effect on
the interpretation of the type of task. If other Actual
information (such as Duration or End Date) is provided, AmiGantt
will simply assume that the task actaully started on the Planned
Start Date.
Actual Duration
This field specifies the amount of time the task took. Its units
of time (days, weeks, or months) depend on the setting of the
Project Calendar type on the Project Header Window. As with the
Planned Duration on the Task Main Window, this field is numeric
only and will not accept negative numbers.
Actual End Date
Here, the date on which the task was finally completed is
recorded. As with all date fields, its format is YYYYMMDD.
AREXX WINDOW
The ARexx Window provides 4 lines of 75 characters each into
which ARExx commands may be entered. Since this is not a great
deal of room for ARexx processing, in most cases this will consist
of a call to execute an ARexx macro file contained in the REXX:
directory.
When the Execute gadget on the Arexx or Task Main Window is
activated, the statements in these four fields will be sent to the
REXX host port directly as commands. Hence, there is no need for
the user to put a 'comment line' in the first line, as is required
in ARexx macro files.
After the appropriate values have been supplied for each of the fields,
the user should select the OK Gadget in the lower left of the window to
add the task to the project. If the user changes his mind about adding
the task, the CANCEL gadget in the lower right of the window may be
selected to return to the Main Screen without effecting any changes.
As with the Modify Header window, the user may move from field to field
down the screen by pressing the RETURN key once he/she has finished
putting the desired value in the field. Pressing RETURN while the
cursor is in the last Cost field will have the same effect as selecting
the OK gadget at the bottom left of the window.
Task Types
There are three types of tasks which may be defined in an AmiGantt
project: HEADERS, MILESTONES, and 'regular' TASKS
HEADERS
...are entries made into the project schedule to separate groups of
tasks or as explanatory notes. They have no effect on the project
schedule and are descriptive only. To insert a HEADER entry, the
Description field should be filled in with the desired information.
All the other fields (such as Start and End Dates, Depends on,
Duration, and Resources) should be left blank.
MILESTONES
...are tasks which record the occurrence of a particular event on
a particular date. Typically, they are goals to be strived for.
To define a MILESTONE, the Description field should be filled in
with appropriate text, the Start Date field may have the desired
target date filled in, and the End Date and Duration fields should be
left blank. As of Version 3.00.00 of AmiGantt, you can set the
Milestone task to be dependent upon the completion of other tasks.
You may fill in Resources if you wish, but these will not be included
in any of AmiGantt's reports.
AmiGantt will display MILESTONES on the Gantt Chart with an
asterisk (*) at the appropriate day.
'Regular' TASKS
...are defined in the normal manner, as described in the Add Task
section above. They define tasks to be completed in the project
and have durations, dependencies (maybe), resources, start dates and
end dates. However, the start and end dates may be implied by the
dependencies. (So you don't fill them in)
Thus, to summarize...
HEADERS -- descriptive only
-- no start date, end date, dependencies or duration
MILESTONES
-- description and start date (or dependencies)
-- no duration
Regular TASK
-- description and duration as minimum
-- start date may float by leaving it blank
-- if end date is left blank, it is calculated based
on start date + duration
-- dependencies may be used to determine start date
-- if dependencies are left blank, start date is assumed
to be the same as project start date
-- if a start date is provided, it is assumed to be the
earliest start date for the task
-- if an end date is provided, it is assumed to be the
latest end date for the task
-- differences between start date + duration and end
date will be shown as a 'float' period
2.4.1 Adding Another Project as a Task
AmiGantt provides a way in which other projects may be added as
sub-projects to the project you are working on. In other words,
another entire project becomes a 'task' of the master project you are
currently defining.
To define this sub-project, the user would set the current task block
at the desired position and select Add Task to display the Add Task
window as described in the previous section.
In the DESCRIPTION field, instead of putting some text about the task
to be completed, the user should put in two slashes ('//') right at
the left-most edge of the field, followed by the volume, directory(ies)
file name, and extensions of the previously saved project file, in
normal AmigaDOS format.
Thus the format of the description line should be --
//volume:directory/file.extension
E.g. if there is another project file I want to add as a sub-project in
file 42X in directory RNDPROJ on volume FRODO, the description line
should look like --
//frodo:rndproj/42x
Note that the entry is case-independent (as is normal for AmigaDOS
convention), i.e. it doesn't matter if you type in upper or lower case
letters.
Although you can specify a start date if you wish to tie it to a
particular date, this field and the rest may be left blank. When the
entry is added, AmiGantt will examine that project file determine the
starting date and duration of the entire project and copy all the
resources from the project file (up to the 10 maximum for a task) into
this task entry.
If the start of this sub-project is dependent upon completion of other
tasks or sub-projects, these task numbers should be filled into the
DEPENDS ON field before selecting the OK gadget to add the task.
2.4 Modifying Tasks
We all make mistakes or change our mind about something, so if the
information within a particular task needs to be altered, or possibly
an actual duration needs to be added, the user may position the current
task block over the task he wishes to change and select Modify Task
from the Task Menu. After doing so, AmiGantt will present the Modify
Task window.
Note that this looks very similar to the Add Task screen mentioned
previously, with all the fields in the task modifiable. The difference
here will be that the various fields will display the existing values
for that task and the window name at the top left corner of the window
will specify the MOD Entry action.
Keeping in mind the same restrictions on data types for each of the
fields as was mentioned in the Add Tasks section of this document, the
user may modify the contents of any field in the task. Values of
fields may be set to zero or blank by simply erasing the value in the
field.
Once the appropriate fields have been changed, select the OK gadget in the
bottom left of the window to record the changes to the task. AmiGantt will
then update the task, and update the complete project schedule with the
new information.
Note, that if changes are made to the project dependencies, it could
take a second or two for AmiGantt to rearrange all the pointers and
reset the various floating start dates. AmiGantt will tell you it is
working on these pointers, etc. by changing the mouse pointer to a
picture of a wristwatch. This signifies a 'Please Wait' condition and
the user should wait until the pointer resumes it's normal shape
before proceeding.
If you decide that you didn't really want to change this task, simply
select the CANCEL gadget in the lower right of the window to return to
the Main Screen without effecting any changes.
2.5 Deleting Tasks
Tasks can be removed from the project by positioning the current task
block over the task to be removed and selecting Delete Task from the
Task Menu. When Delete Task is selected, AmiGantt will present the
user with the Delete Task window. (Which looks suspiciously similar to
the Add Task and Modify Task windows).
If the user decides this is, indeed, the task he wishes to delete, he
should select the OK gadget in the bottom left of the window to confirm
the removal. If he decides otherwise, selecting the CANCEL gadget in the
lower right will return him to the Main Screen with no changes.
Once a task has been deleted, AmiGantt will go through all the other
tasks in the project and remove any dependencies upon the deleted
tasks. If another task was dependent only upon the deleted task, then
its dependency will revert to the project start date. Since all the
tasks after the deleted tasks are automatically renumbered, AmiGantt
will also examine tasks after the deleted task to adjust their
dependencies.
2.6 Saving the Project (Save Project or Save As Project)
Once the project has been completely defined and all the tasks have
been entered, it would be wise to save the project to a permanent
storage file on disk. Then, the project may be retrieved for update
at a later time or included as part of a bigger project, as outlined
in section 2.4.1.
To save the contents of the project to disk, the user selects either
Save or Save As from the Project Menu. For a new project, the user
should select the Save As option which will allow him/her to create a
new file and supply a name for the project file. If the project was
loaded from a previously created file, the Save option may be selected
to overwrite the file with the new changes.
Assuming we are creating a new project and the Save As option is
selected, AmiGantt will display a file requestor window in which the
user may either select an existing file or provide the name of a new
file to be created.
The requestor supplied in version 3.00.00 of AmiGantt and above is
produced by the ARP (AmigaDos Replacement Program) library functions
attached to AmiGantt and includes some new features not normally found
on file requestors.
The list of files shown defaults to the current directory from
which AmiGantt was run. As before, the filenames may be selected
by clicking on them with the left mouse button. The scroll bar
at the right of the requestor box will move through the sorted
filename entries. Once the filename you wish is displayed, you may
click on it, then on the OK box to select it.
One of the added features of the ARP requestor is the ability to
change the list to display the available devices by pressing the
right mouse button. Then you may navigate through the directories
of any device simply by clicking (with the left mouse button) on
the directory shown. You can return back up one level by
clicking on the 'Parent' button or redisplay the list of devices
by re-pressing the right mouse button.
In Save As mode, the filename box of the requestor is auto-selected
so you can begin typing in the name for your new file as soon as
the requestor appears -- instead of waiting for it to complete
the display of the directory.
The user should supply the name of the file, directory, and volume he
wishes to save the project in. It's a good idea to use a suggestive
name for the project file name, since it will then make it easier to
remember for later retrieval and will make more sense if the file is
included as a sub-project to some other, larger project.
Naming conventions for project files follow the standard AmigaDOS file
conventions. Once the appropriate information has been supplied the
user selects the OK gadget to write the project out to the file. If a
file by that name already exists, AmiGantt will notify the user and
give him a chance to decide whether he wishes to overwrite the existing
file or not.
If the user wants to overwrite the existing file, he should select the OK
gadget in the lower left of the requestor box. AmiGantt will then
erase the contents of the existing file and replace them with the new
project file.
If instead, he wishes to keep the existing file and provide a new file
name for the project, he should select the CANCEL gadget in the lower
right of the requestor box. AmiGantt will then return to the main
screen, without making any changes.
AmiGantt -- Project Management Software
3.0 Printing a Project
3.1 Printing a Screen
From the Main Screen, the contents of a displayed screen can be dumped
out to the user's default printer device (PRT:) by selecting Screen
from the Print menu. After selecting this option, AmiGantt will
display the PIP (Printing in Progress) pointer and a graphic dump of
the screen on display will be sent to the printer. Due to the manner
in which AmigaDOS accomplishes this dump, the user should avoid making
changes to the screen while the printout is proceeding.
As mentioned earlier, if the user has selected output to a file,
instead of the printer, AmiGantt will generate IFF files of each of
the windows open at the time the request is made. The files created
will have suffixes of _gantt.iff, _pert.iff, and _resource.iff added
to the file name supplied. As it is saving each of the windows,
AmiGantt will bring the window to the front of the display to let the
user know what is going on.
3.2 Printing the Project
Printing out the contents of an entire project via screen dumps would
not be the most economical nor useful method of seeing the project as
a whole, so AmiGantt provides a Project Print function which will
provide a number of different reports about the project. Included in
these reports are the following --
a) GANTT chart
b) Task List and Summary
c) Resource Summary
d) Resource Histogram
e) Pert chart
Each of these reports are discussed in more detail below.
To generate these reports, the user selects Project from the Print
Menu. AmiGantt will change the mouse pointer to the PIP (Printing in
Progress) picture while it is generating the reports. It will return
to the 'normal' pointer when the report is completed. Version 3.00.00
and above of AmiGantt will then check the Preference settings for your
printer to determine if they are suitable for the reports. They
should be set at:
a) 15 pitch, if you have narrow tractor paper
b) a left margin of 8 or less
and c) a right margin of at least 140
If any of these are not correct, AmiGantt will present a
requestor asking if you wish to have AmiGantt send the correct
sequences to the printer to set it up. If you select OK, AmiGantt
will use the driver selected in Preferences to send the appropriate
escape sequences to set the pitch and the right margin.
At any time during the printing of the reports, the user may stop
the printing by pressing the ESC key on the keyboard. If the
printer has a large data buffer though, the printout may continue
for a short time after the ESC key has been pressed.
For the Gantt Chart, Pert Chart and Resource Histogram, two types of
printout are available -- selected by the Type option of the Print
menu. The GRAPHIC option, which is the default, provides high quality
bit-map grpahic printouts on printers that can support this output.
It uses the graphics options of the printer driver specified in the
Preferences program (such as graphic density and orientation). Note,
AmiGantt creates only black and white output. It does not produce
colour printouts.
The second option is the TEXTUAL, which produces ASCII-character based
representations of the Gantt, Pert, and Resource charts (much as in
earlier versions of AmiGantt. This option should be selected if your
printer does not support bitmap graphics printing.
3.2.1 Gantt Chart
As outlined in the Introduction section of this manual, AmiGantt
was designed around the Gantt Chart model in order to provide a simple,
top-down interface in the definition and management of projects. The
main screen interface and printouts of AmiGantt are simplified Gantt
Chart representations.
On the Gantt Charts, tasks are displayed using an extended shaded bar
to show the start date and duration of the task. 'Float' periods
between the last day of the duration and a 'latest end date'
established when the task was added, are shown by a hollow bar
positioned after the duration bar.
Milestones are shown on the chart using asterisks (*).
Actual Durations of tasks are shown using a filled bar, printed over
the planned shaded bar.
In the report printouts provided by AmiGantt, the Gantt chart will
show the entire project (or as much of it as possible) on a single
page. If the project should go beyond either 60 tasks (the vertical
limit) or dates shown on the printout calendar (depends on the type
of project calendar) then AmiGantt will generate a new page of
printout to cover the next portion of tasks or calendar. These extra
pages are generated in such a way so that the entire project can be
'glued together' into one master sheet by attaching additional date
sheets to the right of the first page and task sheets to the bottom
of the first page.
On the Gantt Chart, project task numbers are shown on the left side,
followed by the complete description. The task start date and duration
are then plotted on the project calendar. Those tasks which are not
completed (no actual duration provided) are shown in light arrows.
Completed tasks are shown as dark blocks.
3.2.2 Task List & Summary
The next report prepared by the project printout function is the
detail task list and summary.
The detail task list shows every task that has been defined for the
project and all information provided for each task. This report
should be used mainly to verify input and dependencies.
The task summary report provides a shorter, less detailed look at the
tasks in the project with additional information regarding planned and
actual costs of the tasks and the entire project.
Beside each task description, the start and end dates of the task are
shown. If the dates shown are for actual start and end (i.e. actual
duration has been provided), an '(A)' will be placed beside each of
the dates. If they are planned start and end, a '(P)' will be placed
beside each date.
Next to the start and end dates for each task is the planned and
actual cost of each task. The numbers presented here are calculated
by AmiGantt from the planned and actual durations and the costs for
each of the resources identified for each task. These Plan and Actual
Costs for the tasks are totalled at the bottom of the page. An example
of the task detail list and task summary are provided in section 5.0
of this manual.
3.2.3 Resource Summary
The AmiGantt printouts also provide a resource summary listing which
shows all of the resources that have been committed to the project,
the planned and actual time commitment of each of those resources,
and the planned and actual costs of the resources during the duration
of the project.
AmiGantt generates this listing by examining each task in the project
and collecting information on each resource defined. The cost
information is gathered by collecting the cost for each resource in a
task and multiplying it by the planned and actual duration of the task.
At the bottom of the page, the total commitment and costs for the
project are totalled for comparison with the total costs provided on
the Task Summary report mentioned earlier.
3.2.4 Resource Histogram
The Resource Histogram produced by AmiGantt is useful in determining
when resources will be required for various stages of the project and
when double-ups occur on a given resource. Frequently, when defining a
project, it is difficult to see when a given person or physical piece
of hardware is expected to be in two places at the same time. The
Resource Histogram, with its overall view of the project from a time
vs. resource basis, quickly shows these inconsistencies.
3.2.5 Pert Chart
The Pert Chart (or Network Chart as it is sometimes known) displays
the tasks in a project and their relationship to each other. Its
display is basically a series of paths from the beginning of the
project to the end, showing the tasks that must be completed along
each path to reach the final goal.
The top path in a Pert Chart is usually the critical path which is
the one in which the combined tasks have the longest duration,
which means that if one of those tasks takes longer than expected,
the entire project will suffer. In AmiGantt however, the top path
on the Pert Chart is simply the one with the most tasks in it.
This was done for display purposes.
AmiGantt -- Project Management Software
4.0 Modifying Existing Projects
4.1 Loading the Project
As mentioned in section 2.1, once a project has been defined and saved,
it can be easily retrieved for modification or update by selecting the
Load option from the Project Menu. Once this option has been selected,
a file requestor will be presented to allow the user to select and/or
define the name of the project file to be loaded.
In this requestor, the user should fill in the file name, directory,
and volume on which a previously defined project file has been stored.
The user should fill in the appropriate information, then select the
OK gadget to request loading of the project. As mentioned before,
this requestor is generated by the ARP library and hence has the
additional capability of displaying a list of all devices by pressing
the right mouse button. The user may then navigate the directories of
any device using the left mouse button and the scroll bar.
AmiGantt will check for the existence of the file and if it is not
found will present an error message and give the user another chance
to define the project file.
If the file does exist, AmiGantt will also check the internal
structure of the file to determine if it is, indeed, a AmiGantt file.
If it is not, the user will be notified via an error message and given
the opportunity to define another file.
If the user wishes not to load a project file, or cannot find the
existing project file, then he can select the CANCEL gadget from the
file requestor to return to the Main Screen.
After successfully defining an existing AmiGantt file and selecting
the OK gadget, AmiGantt will read the file, load in all the tasks, and
return the user to the Main Screen which has been updated with the
first 20 tasks and their calendar mappings. At the same time,
AmiGantt will also load the previously defined header information and
will change its calendar display to match the header entry.
At this point, the user is free to change the project as desired or
produce printouts of the project.
4.2 Modifying the Header Information
Once an existing project has been loaded, the user may choose to
change any or all of the information in the tasks or to add new tasks.
He may also wish to change any of the information in the Project
Header. As mentioned in section 2.3, the project header information
may be accessed by selecting the Modify Header option on the Task Menu.
In the case of 'loaded' projects, this screen will now display the
header information provided when the project was created or last
modified. The user may choose to change any of the information in
this header, and select the OK gadget to record the changes.
If the user changes the project calendar, a message will be presented
at the top of the screen, asking if the project tasks should be
converted to the new base.
If the user selects the NO gadget at the lower right of the requestor
box, AmiGantt will change the project calendar, the calendar display
on the Main Screen, and assume that all duration entries in the tasks
should be converted directly to the new calendar base. In other words,
if the previous calendar base was D for Daily, and the user changes
the project calendar to M for monthly and says NO to the conversion,
then a task duration that was originally 2 days will become 2 months.
Similarly, a task resource that used to have a cost of $100 per day,
will now have a cost of $100 per month.
Selecting the OK gadget will cause AmiGantt to convert the task
durations from the original calendar base to the new calendar base
using the rules outlined below.
4.2.1 Conversion of Costs/Durations
Original Base New Base Conversion Factor
------------- -------- --------------------
Daily Weekly Divide duration by 5
Multiply cost by 5
Daily Monthly Divide duration by 22
Multiply cost by 22
Weekly Daily Multiply duration by 5
Divide cost by 5
Weekly Monthly Divide duration by 4
Multiply cost by 4
Monthly Daily Multiply duration by 22
Divide cost by 22
5.0 Input ARexx Port
As mentioned in the Features section of this document, AmiGantt
4.00.00 supports an input ARexx port in addition to the command
port attached to each task. This input port allows the user to
run some of the functions of AmiGantt from an Arexx macro.
The functions supported at the input port include:
a) Loading an AmiGantt version 3 or 4 project file
b) Opening the Pert or Resource Windows
c) Closing the Pert or Resource Windows (once opened)
d) Printing the Tasks, Gantt Chart, Pert Chart, Resource
Histogram or the entire project file
e) Quitting out of AmiGantt.
Commands are sent to the AmiGantt input port as text strings
from the ARexx macro. Some commands take additional parameters
as a second text string. An example macro for AmiGantt is
shown below. The name of the port is AmiGanttPort.
/* RexxAmiGantt - an ARexx program to test the input interface to
AmiGantt version 4.0 */
address COMMAND
'run dh1:csource/amigantt40/amigantt'
/* wait for the AmiGantt Port to come up */
do while (SHOW('Ports','AmiGanttPort')=0)
nop
end
address 'AmiGanttPort' 'load dh1:csource/amigantt40/wazoo'
address 'AmiGanttPort' 'open pert'
address 'AmiGanttPort' 'open resource'
address 'AmiGanttPort' 'quit'
/**************************************************************/
The Commands supported are:
LOAD <parameter> to tell AmiGantt to load and display a version 3
or 4 project file. The full file name (max of
255 characters including volume and directories)
should be provided as the <parameter>.
OPEN <parameter> to open specific information windows on a project.
Valid values for <parameter> are
RESOURCE and
PERT
Each parameter will open the Resources and Pert
window respectively.
CLOSE <parameter> Closes the Resource or Pert Windows, if they are
open. Valid values for <parameter> are:
RESOURCE and
PERT
as in the OPEN command.
QUIT to close all windows and exit from AmiGantt. Note
there is no parameter required with this command.
PRINT <parameter> to print out various parts of the project. At this
time, the print defaults (text vs graphics, file
vs printer, etc.) cannot be set via the ARexx input
port. Thus, AmiGantt will use the regular defaults.
Valid values for <parameter> are:
TASKS
PERT
RESOURCES
GANTT
FILE
These print parameters have the same effect as the
equivalent entries in the PRINT menu.
If the AmiGantt ARexx port processor encounters a command it cannot
recognize, it will return a result value of 20 and an "Invalid
Command" result string.
If an invalid project file is provided as a parameter to the LOAD
command, AmiGantt will display the "Invalid file" requestor, and
the port will return a result value of 10.
On successful completion of each command, the result value will
be zero.
6.0 Enhancements to version 4.00.00 of AmiGantt
and known anomolies
6.1 Enhancements
1. The file format of AmiGantt projects has changed with this version.
Version 4.00.00 can load and read version 3.00.00 and above project
files. When you Save the file, it will be automatically converted
to version 4.00.00 format.
2. The Pert Chart now uses the Helvetica 9 font, which is provided on
the standard WorkBench 1.3, rather than the special Gantt 6 font
provided in earlier releases. It makes the printouts look better.
3. Resource information now includes 'percentage use' to define how
much of a person's total time is dedicated to this task. The
Resource Histogram display and costing reports will use this
percentage to adjust the total committment of the person.
4. AmiGantt now opens its own 8 colour screen which makes it easier to
drag all the windows away at once and permits more extensive use of
colour on the Gantt and Resource charts. The colours may be
adjusted from the Modify Colours option of the MISC menu. Changes
in colour are automatically saved with each project.
5. AmiGantt 4.00.00 has two AREXX interfaces:
a) An input port which allows the user to run certain
functions of AmiGantt from an ARexx macro; and
b) An output port from which ARexx commands attached to any
Task can be executed to run other ARexx-compatible
programs such as editors, IFF file displays, and spread-
sheets.
6. AmiGantt 4.00.00 now recognizes when actual changes have been made
to a project and presents the "Are you sure..." requestor only if
there is a danger of losing the changes.
7. A number of problems with the display and printout of Monthly Gantt
charts have been corrected. These were manifested by either all
the bars being stacked against the left side of the chart, or the
bars being in the wrong positions.
6.2 Known Anomolies
1. The Move Task function has not yet been implemented. (Sorry about
that -- it's more complicated than I thought)
2. Once a task sort has been completed, there is no way to 'undo' this
to return to the original order.
3. AmiGantt 4.00.00 is more memory intensive than earlier versions, in
that it opens up its own 8-colour screen. The resolution (medium,
interlaced) is determined from the settings in Preferences. It will
also take advantage of overscan and PAL sizes, so it is possible to
run out of available CHIP memory. At this time, there is no way
to force AmiGantt to open a WorkBench screen, as it did in earlier
versions.
4. The Pert Chart is generated by starting at the last task in the project
(denoted by the latest starting date) and working backwards through the
dependency network. If you have tasks which are not connected in some
way to the last task, then they will not show up on the Pert Chart.
5. Although the top line in a Pert Chart is normally the critical path, for
ease of display, AmiGantt puts the path with the greatest number of tasks
at the top of the Pert. In most cases, this will also be the critical
but not always. The Sort on Critical Path and Identify Critical Path
options work correctly, selecting the path which has the longest planned
duration.
6. Sorry, but because of difficulties in adjusting the text for use in
the Gantt chart, I've had to force the screen text font to topaz 8 for the
time being. I will change AmiGantt to make use of the default font in a
maintenance release.